home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / nftp083.zip / NFTP-MAN.TXT < prev    next >
Text File  |  1996-09-27  |  40KB  |  955 lines
  1. DRAFT. EXPECT SOME OMISSIONS AND INACCURACIES
  2. ----------------------------------------------------------------------------
  3.  
  4. NFTP : New File Transfer Protocol Client Version 0.83
  5. Copyright (C) 1994-1996 Sergey Ayukov
  6.  
  7. ----------------------------------------------------------------------------
  8. Home page of NFTP is http://crydee.sai.msu.su/nftp/
  9. Check it for new versions, updates etc.
  10.  
  11. Contents
  12.  
  13.   1. Introduction
  14.   2. Installation
  15.   3. Quick start
  16.   4. Usage
  17.         o Launching NFTP
  18.         o Logging in and out
  19.         o Behind the firewall
  20.         o Navigating remote site and local directories
  21.         o Transferring files
  22.         o Customizing NFTP
  23.   5. Keyboard commands summary
  24.         o General keyboard commands
  25.         o Control connection window
  26.         o File listing (remote and local)
  27.         o Entry fields
  28.         o Bookmark list
  29.         o Built-in file viewer
  30.   6. Known bugs and limitations
  31.   7. Troubleshooting
  32.   8. Licensing information
  33.   9. Acknowledgements
  34.  10. Registration
  35.  11. Contacting the author
  36.  12. Version history
  37.  
  38. ----------------------------------------------------------------------------
  39.  
  40. INTRODUCTION
  41.  
  42. NFTP is a text-mode ftp client for OS/2. Comparing to popular ncftp, it has
  43. a number of enhancements:
  44.  
  45.    * remote directory view is fully scrollable with minimum keystrokes
  46.      required;
  47.    * remote directory contents is cached during one session - you'll never
  48.      have to wait for retrieving the same listing;
  49.    * marking files for download/upload: you don't need to type filenames at
  50.      all;
  51.    * remote file viewing is more simple and intelligent, and viewed files
  52.      are cached as well;
  53.    * you can see client-server negotiation (even complete history during all
  54.      run);
  55.    * NFTP has batch progress indicator (you see how long will take entire
  56.      operation if more than one file was selected to transfer);
  57.    * file selection is simple and allows to view remote files while marking
  58.      others to transfer;
  59.    * you can skip files during transfer while continuing to download/upload
  60.      the rest;
  61.    * you can mark files in different directories and then retrieve them all;
  62.    * you can sort remote directories by name, size, date/time.
  63.    * NFTP comes in 12 languages: Brazilian Portuguese, Chinese, Danish,
  64.      Dutch, English, German, Hungarian, Italian, Japanese, Norwegian,
  65.      Russian, Spanish, Swedish.
  66.  
  67. The biggest advantages over majority of PM ftp clients (like FTP-PM, sftp
  68. etc.) are the ability to 'reget' (continue transfer after interruption),
  69. speed of simple and effective text-mode interface, small memory
  70. requirements.
  71.  
  72. In my opinion, LW-FTP while being very elegant is useless due to big
  73. overhead of Workplace Shell object creation/deletion.
  74.  
  75. OS/2 4.0 (Merlin) has introduced concept of 'FTP Folder', similar to LW-FTP
  76. and offering seamless integration of FTP client and Workplace Shell (via WPS
  77. class). They are funny and easy to use, but play and work are different
  78. things. If you really need to transfer files regularly and in large
  79. quantities you'll look for more useful and less fancy program than 'FTP
  80. Folder'.
  81.  
  82. However, NFTP isn't free as ncftp. But registration fee is only US$ 20 --
  83. and you'll get all future versions and support by e-mail at this price! See
  84. registration details below.
  85. ----------------------------------------------------------------------------
  86.  
  87. INSTALLATION
  88.  
  89.   1. Requirements are
  90.         o OS/2 2.x or later;
  91.         o TCP/IP stack: IBM TCP/IP 2.0 for OS/2, OS/2 Warp Connect, OS/2
  92.           Warp Internet Access Kit;
  93.         o HPFS formatted drive to be able to download files which are not
  94.           8.3-compliant.
  95.         o In addition, you also have to install emx runtime package. If you
  96.           don't have it installed, file "emx.dll" is supplied with this
  97.           version of NFTP. Copy it into any directory listed in your
  98.           LIBPATH. If you want to obtain complete emx runtime package and/or
  99.           its source, you can get it from the following anonymous ftp
  100.           servers:
  101.           ftp.uni-stuttgart.de:/pub/systems/os2/emx-0.9b/
  102.           hobbes.nmsu.edu://os2/unix/emx09b/
  103.           ftp.cdrom.com:/pub/os2/lang/emx09b/
  104.           ftp.sai.msu.su:/pub/os2/programming/emx-0.9b/
  105.           EMX runtime support is contained in file emxrt.zip; instructions
  106.           on installing it can be found inside archive.
  107.   2. Installation.
  108.  
  109.      Unpack archive nftp*.zip into some directory and run install.cmd. After
  110.      answering some questions necessary files will be copied to the
  111.      directory you specified and your WPS desktop will hold two new objects
  112.      -- "NFTP" (executable) and "NFTP Manual". You probably already done
  113.      that because you're reading that "NFTP Manual"!
  114.  
  115.      If you want to install NFTP by hand (without install.cmd), copy all
  116.      files into the directory of your choice (eg, "d:\apps\tcpip\nftp"),
  117.      load nftp.ini into your favourite ASCII text editor (eg, TEDIT shipped
  118.      with Warp) and insert your e-mail address (it will be used as a
  119.      password for anonymous logins) at the appropriate place (line
  120.  
  121.                anonymous-password="your-e-mail-address"
  122.  
  123.  
  124.      ). I also suggest to decide where you will keep your bookmarks and
  125.      transfer history and set corresponding variables accordingly. If you
  126.      like to launch programs from desktop, create program object for NFTP.
  127.      Put supplied nftp.mrk file into the directory which you've chosen in
  128.      nftp.ini.
  129.  
  130.      The language NFTP uses is determined by environment variable NFTP_LANG.
  131.      It should be set to the name (without extension) of corresponding DLL
  132.      file. E.g., if you want to use Japanese version, you should use
  133.  
  134.                set NFTP_LANG=japanes
  135.  
  136.  
  137.      This statement can be put to config.sys or to the batch file invoking
  138.      nftp (install.cmd does exactly this). If you only need English version
  139.      you may omit this variable.
  140.  
  141.      install.cmd creates Workplace shell object to run NFTP. This feature
  142.      can be useful even you are die-hard command-line user (see below). NFTP
  143.      can run in a fullscreen session or in a VIO window. Installation script
  144.      sets it to run in a window, and window will not be closed automatically
  145.      after exit -- this can help to diagnose problems. Turn it off when
  146.      everything works as expected.
  147.  
  148. ----------------------------------------------------------------------------
  149.  
  150. QUICK START
  151.  
  152. After installation, run nftp.exe (from command line or WPS object). If
  153. you're launching NFTP from WPS object created by installation script you
  154. will be asked to enter "FTP server to log in"; simply press ENTER now. You
  155. should see list of bookmarks on the screen. Use cursor keys to select one of
  156. them and press ENTER. If everything is set up correctly, you'll see
  157. client-server negotiation and then finally list of files and directories on
  158. the ftp server you've chosen. Hit SPACE to view control connection window
  159. (and it is scrollable!), TAB to view local files/directories. Return to
  160. remote directory view by pressing space/tab another time. Move pointer with
  161. cursor keys, press ENTER on a directory to enter it. If you know name of the
  162. file (or first symbols of the name), type it directly: NFTP will try to
  163. position cursor on a file which name starts with these symbols. Select files
  164. to download with INSERT or simply press F5 to transfer single file. To
  165. upload file to server, switch to local files view (with TAB), select file(s)
  166. and press Shift-F5. To view local or remote file, move pointer to it and
  167. press F3 (of course, remote file will be downloaded first -- that will
  168. probably take some time). Navigating in the viewer is simple and intuitive:
  169. scroll file with cursor keys. Press F10 to log off and exit NFTP.
  170. ----------------------------------------------------------------------------
  171.  
  172. USAGE: LAUNCHING NFTP
  173.  
  174. You often already know where the file you need right now is located. Let's
  175. suppose, say, you want to retrieve RFC 959 from
  176.  
  177.        src.doc.ic.ac.uk:/pub/rfc/
  178.  
  179.  
  180. Launch nftp in the following fashion:
  181.  
  182.        nftp  src.doc.ic.ac.uk:/pub/rfc
  183.  
  184.  
  185. or
  186.  
  187.        nftp  src.doc.ic.ac.uk/pub/rfc
  188.  
  189.  
  190. After logging in into src.doc.ic.ac.uk nftp will change directory for you to
  191. /pub/rfc. Having directory listing before you, start typing 'rfc959': cursor
  192. will be positioned on rfc959.txt.gz. You will then locate required file and
  193. download it.
  194.  
  195. The command line format for NFTP is:
  196.  
  197.       nftp [hostname[[:[port]]directory]   [userid]
  198.  
  199.  
  200. "hostname" is the name of ftp server ('src.doc.ic.ac.uk' in the above
  201. example), ":" can be omitted, "directory" is remote directory ('/pub/rfc' in
  202. the above example), "port" is port number (don't use it if you don't know
  203. what's it). If you have an account on ftp server (i.e. you're not anonymous
  204. user), you can specify your userid in the command line. You will be asked
  205. for a password. An important note -- there shouldn't be any spaces between
  206. hostname and directory! Another examples are:
  207.  
  208.       nftp private.crlf.net:7500/users    (nonstandard port)
  209.       nftp ftp/pub                        (domain suffix omitted)
  210.       nftp 128.128.128.128:/mydir         (IP number instead of host name)
  211.       nftp lnfm1.sai.msu.su/home/asv asv  (login with explicit directory and
  212.                                            real password)
  213.  
  214.  
  215. Specifying directories in a command line is a pretty useful feature: when
  216. you've found some reference, paste it directly into the command line (e.g.,
  217. File Commander/2 1.4 allows this) and you'll get right into the place
  218. without typing anything except Ctrl-Ins and Shift-Ins! Note that it's
  219. impossible to specify filename on the command line -- use directory name,
  220. not file name (i.e. /pub/rfc instead of pub/rfc/rfc959.txt.gz in the above
  221. example).
  222.  
  223. NFTP will try to use any text mode you have set before starting it. Modes
  224. with 80 columns work rather good, but do not expect this from 132-col or
  225. other modes.
  226. ----------------------------------------------------------------------------
  227.  
  228. USAGE: LOGGING IN AND OUT
  229.  
  230. NFTP has several ways to choose ftp server:
  231.  
  232.    * you can specify ftp server on the command line (see previous chapter,
  233.      "USAGE: LAUNCHING NFTP"; examples can be found there as well).
  234.    * if you don't need to put server into bookmark list (i.e. you want to
  235.      visit it only once), use Ctrl-L and Ctrl-N keys. Ctrl-L invokes
  236.      anonymous login procedure, and Ctrl-N will also ask for userid and
  237.      password. Later you may decide that the site is worth attention and
  238.      want to put it into bookmark list -- press F4 to add current directory
  239.      on a current server to the bookmark list. Unfortunately, currently you
  240.      can only add sites in such a way to the end of the list. To sort the
  241.      bookmark list, use any ASCII editor. To log off, use Ctrl-K; F10 will
  242.      log off and exit NFTP.
  243.    * you can server's hostname and (optionally) initial directory into the
  244.      bookmark list if you frequent this site. Locate file 'nftp.mrk' or
  245.      whatever is set in 'bookmarks-file' in NFTP.INI and load it into ASCII
  246.      editor. Insert new line in any place and fill it following this
  247.      template:
  248.      userid <space> hostname <space> : <space> directory
  249.      <space> is blank character here. All fields, excluding directory, are
  250.      obligatory. When directory is omitted, colon must present. Format of
  251.      bookmark file will change in near future; I plan to add comments and
  252.      some kind of folders to get more compressed list.
  253.  
  254.      If you don't like editing text files, start NFTP and when you'll be
  255.      prompted one of bookmarks, press INSERT to add new site. Fill all
  256.      fields and press ENTER. Select newly added server with cursor keys and
  257.      press ENTER again to login to site.
  258.  
  259. ----------------------------------------------------------------------------
  260.  
  261. USAGE: BEHIND THE FIREWALL
  262.  
  263. NFTP can be used if your machine is located behind the firewall. There are
  264. several kinds of firewalls (and may be even other types not documented
  265. here). Unfortunately, I cannot test NFTP with any type of firewall because I
  266. don't have one. So I have to relay on independent testers. If NFTP does not
  267. work with your firewall software, please contact me and I will try to fix
  268. the situation. I would also appreciate your report about whether NFTP works
  269. with your firewall, how your firewall software is called and to what type it
  270. belongs (see below about firewall types). Here are six types of firewalls
  271. supported by NFTP:
  272.  
  273.   1. SITE hostname
  274.      Firewall host, userid and password are required. User is logged on the
  275.      firewall and the remote connection is established using SITE
  276.      remote_host.
  277.   2. USER after logon
  278.      Firewall host, userid and password are required. User is logged on the
  279.      firewall and the remote connection is established using USER
  280.      remote_userid@remote_host
  281.   3. USER with no logon
  282.      Firewall host required, userid and password are ignored. USER
  283.      remote_userid@remote_host is sent to firewall upon initial connection.
  284.   4. Proxy OPEN
  285.      Firewall host required, userid and password are ignored. OPEN
  286.      remote_host is sent to firewall upon initial connection.
  287.   5. PASV mode
  288.      There is another kind of firewall, which is not specifically
  289.      configured. A router-based firewall is one which allows connections to
  290.      be established in one direction only. The router itself is invisible to
  291.      the user. However, the default mode within FTP is that "data"
  292.      connections are established by the server rather than the client. To
  293.      work with a router-based firewall requires using the PASV Mode of FTP.
  294.  
  295. You decide of what type your firewall is, and then edit NFTP.INI setting
  296. appropriate variables:
  297.  
  298. ;
  299. ;firewall-type=0
  300. ;
  301. ;firewall-host=
  302. ;
  303. ;firewall-login=
  304. ;
  305. ;firewall-password=
  306. ;
  307. ;firewall-port=
  308. ;
  309. ;use-PASV-mode=0
  310.  
  311. ----------------------------------------------------------------------------
  312.  
  313. USAGE: NAVIGATING REMOTE SITE AND LOCAL DIRECTORIES
  314.  
  315. With NFTP, you work with remote directories like using some kind of
  316. filemanager. List of files is scrollable; you can view, delete, rename files
  317. and directories, create new directories, sort file list by different
  318. criteria, mark and unmark files, quickly search for file if you know its
  319. name, change directories etc. Some actions will succeed only if you have
  320. sufficient rights, of course. Most anonymous servers allow to create
  321. directories and upload files only to special 'incoming' directory; in other
  322. directories you can't manipulate directory contents.
  323.  
  324. Complete list of available commands is in the Keyboard Commands Summary
  325. section. You can also view it while working with NFTP - just press F1. F1
  326. displays context-sensitive help, i.e. keystrokes valid in the current mode.
  327. Shift-F1 shows general (rather brief) information about program usage.
  328. ----------------------------------------------------------------------------
  329.  
  330. USAGE: TRANSFERRING FILES
  331.  
  332. ----------------------------------------------------------------------------
  333.  
  334. USAGE: CUSTOMIZING NFTP
  335.  
  336. Almost all customizations are done through NFTP.INI. This file usually
  337. resides in the same directory as NFTP.EXE itself. However, you can also
  338. place it into PATHed directory or current directory.
  339.  
  340. The file NFTP.INI is plain ASCII file and can be edited with any ASCII
  341. editor (e.g., "System Editor" or "TEDIT"). Lines starting with semicolon ";"
  342. are comments; empty lines are ignored. The file itself holds comments about
  343. configuration and parameter meaning.
  344.  
  345. Note that only one entry in NFTP.INI is required -- your e-mail address
  346. (anonymous-password). All other fields are commented by default
  347. (installation script sets log-transfers-name and bookmarks-file). Do not
  348. forget to remove leading ";" when doing customizations.
  349.  
  350. To get rid of overhead of parsing of text initialization file, NFTP converts
  351. NFTP.INI into NFTP.BIN. This operation is done only when necessary (i.e.
  352. when NFTP.BIN does not exist or older than NFTP.INI). Conversion is fully
  353. automatic and done by NFTP-OPT. Please note that file NFTP-OPT.EXE should be
  354. placed into the same directory as NFTP.INI or into the directory listed in
  355. PATH environment variable. In general, you shouldn't worry about it.
  356.  
  357. Complete explanation of all parameters in NFTP.INI is in NFTP.INI itself. I
  358. feel it is more appropriate place than this manual; it makes little sense to
  359. duplicate information here.
  360.  
  361. Parameters can be of one of three types: integer, boolean and string.
  362. Integer values are represented by integers :-) and can be prefixed by sign.
  363. Boolean values can be specified as "0", "n", "no" (false), "1", "y", "yes"
  364. (true) (WITHOUT! quotes). Different capitalization (e.g., "Yes") can also be
  365. used. Strings are represented by character sequencies enclosed into double
  366. quotes; if value contains only letters, digits and minus sign you can safely
  367. omit quotes.
  368.  
  369. The following table lists valid keyboard combinations which can be used in
  370. NFTP. "Y" means that this keystroke can be used; "--" -- keystroke cannot be
  371. assigned (it's not generated at all or intercepted by system); "N/R" -- not
  372. recommended (e.g., better leave Esc or Enter bound to defaults); "char" --
  373. generates plain ASCII character code.
  374.  
  375.            VALID KEY COMBINATIONS: FUNCTION AND ALPHANUMERIC KEYS
  376.     Key     Plain          Shift               Alt              Ctrl
  377.  esc        N/R    same as 'esc'         --               --
  378.  f1-f12     Y      Y                     Y                Y
  379.  ~ `        char   char                  Y                --
  380.  1 !        char   char                  Y                --
  381.  2 @        char   char                  Y                Y
  382.  3 #        char   char                  Y                --
  383.  4 $        char   char                  Y                --
  384.  5 %        char   char                  Y                --
  385.  6 ^        char   char                  Y                Y
  386.  7 &        char   char                  Y                --
  387.  8 *        char   char                  Y                --
  388.  9 (        char   char                  Y                --
  389.  0 )        char   char                  Y                --
  390.  - _        char   char                  Y                Y
  391.  + =        char   char                  Y                --
  392.  | \        char   char                  Y                Y
  393.  backspace  N/R    same as 'backspace'   Y                Y
  394.  tab        N/R    N/R                   N/R              N/R
  395.  enter      N/R    same as 'enter'       Y                Y
  396.  a-z        char   char                  Y                Y
  397.  { [        char   char                  Y                same as 'esc'
  398.  } ]        char   char                  Y                Y
  399.  : ;        char   char                  Y                --
  400.  " '        char   char                  Y                --
  401.  < ,        char   char                  Y                --
  402.  > .        char   char                  Y                --
  403.  ? /        char   char                  N/R              --
  404.  Space      char   same as 'space'       same as 'space'  same as 'space'
  405.  
  406.          VALID KEY COMBINATIONS: NAVIGATION KEYS AND NUMERIC KEYPAD
  407.     Key           Plain            Shift        Alt           Ctrl
  408.  insert     N/R               same as 'insert'  Y    Y
  409.  delete     N/R               same as 'delete'  Y    Y
  410.  home       N/R               same as 'home'    --   Y
  411.  end        N/R               same as 'end'     Y    Y
  412.  pgup       N/R               same as 'pgup'    Y    Y
  413.  pgdn       N/R               same as 'pgdn'    Y    Y
  414.  up         N/R               same as 'up'      Y    Y
  415.  down       N/R               same as 'down'    Y    Y
  416.  left       N/R               same as 'left'    Y    Y
  417.  right      N/R               same as 'right'   Y    Y
  418.  num /      same as '/'       same as '/'       Y    Y
  419.  num *      same as '*'       same as '*'       Y    Y
  420.  num -      same as '-'       same as '-'       Y    Y
  421.  num +      same as '+'       same as '+'       Y    Y
  422.  num enter  same as 'enter'   same as 'enter'   Y    same as 'ctrl-enter'
  423.  num 1      same as 'end'     same as '1'       --   same as 'ctrl-end'
  424.  num 2      same as 'down'    same as '2'       --   same as 'ctrl-down'
  425.  num 3      same as 'pgdn'    same as '3'       --   same as 'ctrl-pgdn'
  426.  num 4      same as 'left'    same as '4'       --   same as 'ctrl-left'
  427.  num 5      Y                 same as '5'       --   Y
  428.  num 6      same as 'right'   same as '6'       --   same as 'ctrl-right'
  429.  num 7      same as 'home'    same as '7'       --   same as 'ctrl-home'
  430.  num 8      same as 'up'      same as '8'       --   same as 'ctrl-up'
  431.  num 9      same as 'pgup'    same as '9'       --   same as 'ctrl-pgup'
  432.  num 0      same as 'insert'  same as '0'       --   same as 'ctrl-insert'
  433.  num .      same as 'delete'  same as '.'       --   same as 'ctrl-delete'
  434. ----------------------------------------------------------------------------
  435.  
  436. KEYBOARD COMMANDS SUMMARY
  437.  
  438. All interaction with NFTP is keyboard-based; there's no mouse support (and I
  439. am not going to implement it -- at least now). This approach is somewhat
  440. tough for novice user, but after some learning it gives the best results in
  441. terms of usability and interaction speed. Here is the list of keystrokes
  442. ("hot keys"); it's divided into several sections each pertaining to specific
  443. mode of operation or action classification.
  444.  
  445.                  GENERAL KEYBOARD COMMANDS
  446.  
  447.     Note that these commands are available almost always
  448.  
  449.     Key                         Meaning
  450.  
  451.  Shift+F1    program information and general keyboard
  452.              commands
  453.  
  454.     F1       brings context sensitive help
  455.  
  456.     F10      logoff from site and quit NFTP
  457.  
  458.   Ctrl-K     logoff from site
  459.  
  460.   Ctrl-B     open bookmark list and log to site from it
  461.  
  462.   Ctrl-L     login as anonymous into new site
  463.  
  464.   Ctrl-N     login with userid/password into new site
  465.  
  466.   Ctrl-V     display version information
  467.  
  468.   Ctrl-A     toggle state of autocontrol flag
  469.  
  470.   Ctrl-T     toggle ASCII/BINARY mode
  471.  
  472.   Ctrl-D     redraw screen (do not re-read remote dir)
  473.  
  474.    Alt-N     send NO OPERATION command (verify connection
  475.              aliveness)
  476.  
  477.   Ctrl-W     sets remote directory view to raw
  478.  
  479.   Ctrl-P     sets remote directory view to parsed
  480.  
  481.              use/inhibit NLST with flags (default is on).
  482.              Some servers
  483.    Alt-F     do not like NLST -lLa. Try if you see strange
  484.              messages from server when retrieving directory
  485.              listing. NOT RECOMMENDED.
  486.  
  487.                  CONTROL CONNECTION WINDOW
  488.  
  489.      Key                         Meaning
  490.  
  491.  arrow keys    move viewpoint
  492.  
  493.      Esc       bring you back to the end of history (same
  494.                as End)
  495.  
  496.     Space      switches to directory view
  497.  
  498.     Alt-Q      send any string to server verbatim (quote)
  499.  
  500.     Alt-C      change to arbitrary directory
  501.  
  502.             FILE LISTING VIEW (REMOTE OR LOCAL)
  503.  
  504.           Key                         Meaning
  505.  
  506.                          Navigating
  507.  
  508.       arrow keys         move cursor around. Horizontal
  509.                          scrolling is also possible
  510.  
  511.  Ctrl-Left/Ctrl-Right    horizontal scrolling by 10 symbols
  512.  
  513.         Ctrl-\           change to root directory
  514.  
  515.        Ctrl-PgUp         goto the directory level higher
  516.                          ("cd ..")
  517.  
  518.        Ctrl-PgDn         chdir to directory under cursor
  519.  
  520.          Enter           same as above
  521.  
  522.          Alt-C           change to arbitrary directory
  523.  
  524.          Space           switch to control connection
  525.  
  526.           F2             select drive letter -- local view
  527.                          only
  528.  
  529.                     Sorting file listing
  530.  
  531.         Ctrl-F3          sort directory by name, dirs first
  532.  
  533.         Ctrl-F5          sort directory by time, then name,
  534.                          dirs first
  535.  
  536.         Ctrl-F6          sort directory by size, then name,
  537.                          dirs first
  538.  
  539.         Ctrl-F7          remove sorting, return to original
  540.                          state
  541.  
  542.         Ctrl-F8          reverse current sort order
  543.  
  544.                      Marking/unmarking
  545.  
  546.        Ctrl-num+         mark all files in current
  547.                          directory
  548.  
  549.        Ctrl-num-         unmark all files in current
  550.                          directory
  551.  
  552.         Insert           mark/unmark file under cursor.
  553.                          Directory cannot be marked
  554.  
  555.            *             invert selection
  556.  
  557.        Alt-num+          mark all files in all visited
  558.                          directories
  559.  
  560.        Alt-num-          unmark all files in all visited
  561.                          directories
  562.  
  563.                      Transferring files
  564.  
  565.                          download file under cursor or
  566.           F5             marked files (if any) -- remote
  567.                          view only
  568.  
  569.        Shift+F5          upload file under cursor or marked
  570.                          files (if any) -- local view only
  571.  
  572.         Alt-F5           download all marked files from all
  573.                          directories -- remote view only
  574.  
  575.          Alt-S           save listing of current directory
  576.                          into file -- remote view only
  577.  
  578.                        Viewing files
  579.  
  580.           F3             view file under cursor, use fast
  581.                          internal viewer
  582.  
  583.         Alt-F3           view file under cursor, use
  584.                          external viewer
  585.  
  586.         Creating/deleting/renaming files/directories
  587.  
  588.           F6             rename file/directory
  589.  
  590.           F7             make directory (you have to have
  591.                          permissions on remote)
  592.  
  593.           F8             delete file or directory under
  594.                          cursor
  595.  
  596.         Ctrl-R           re-read directory (refresh file
  597.                          list)
  598.  
  599.                        Miscellaneous
  600.  
  601.           F4             save this place as a bookmark
  602.  
  603.    alphanumeric keys     quick search for files starting
  604.                          with these symbols
  605.  
  606.                         ENTRY FIELDS
  607.  
  608.           Key                         Meaning
  609.  
  610.        Esc/Enter          abandon/confirm
  611.  
  612.    Left, Right, Home,
  613.           End             move cursor around
  614.  
  615.      Tab, Shift-Tab       move to next/previous field (if
  616.                           any)
  617.  
  618.      Del, Backspace       delete characters
  619.  
  620.    Pressing any keys different from Left, Right, Home, End
  621.                will clear the initial string.
  622.  
  623.                        BOOKMARK LIST
  624.  
  625.        Key                         Meaning
  626.  
  627.     arrow keys      move cursor
  628.  
  629.       Enter         select bookmark
  630.  
  631.        Esc          abort (leave bookmark list)
  632.  
  633.        Del          delete bookmark
  634.  
  635.       Insert        create new bookmark
  636.  
  637.                     BUILT-IN FILE VIEWER
  638.  
  639.        Key                          Meaning
  640.  
  641.     arrow keys      scroll (note that you can scroll
  642.                     horizontally also)
  643.  
  644.  Ctrl-Left/Right    scroll by 10 symbols horizontally
  645.  
  646.         F7          search for text string
  647.  
  648.      Shift-F7       repeat search for text string
  649.  
  650.      F2/Alt-S       save contents to file
  651.  
  652.        Esc          exit viewer
  653.  
  654. ----------------------------------------------------------------------------
  655.  
  656. KNOWN BUGS AND LIMITATIONS
  657.  
  658.   1. Not all ftp servers are supported. Most ftp servers in the world use
  659.      wu-ftpd under Unix as their server software, so you shouldn't
  660.      experience this trouble too often. Nearly all Unix ftp servers are
  661.      supported. IBM TCP/IP 2.0 for OS/2 ftpd and Windows NT ftpd are
  662.      supported too.
  663.   2. When running with 'debug=1', your password will be recorded in debug
  664.      tracefile -- beware!
  665.   3. When running with 'debug=1', run nftp off HPFS partition - debug file
  666.      has long filename with two dots.
  667.   4. Error handling is still pretty primitive
  668.  
  669. ----------------------------------------------------------------------------
  670.  
  671. TROUBLESHOOTING
  672.  
  673. Q: nftp says "emx not found".
  674.      A: You don't have emx runtime package installed. Read INSTALLATION
  675.      section again.
  676. Q: nftp crashes, saying "core dumped".
  677.      A: If you can repeat situation, please send me details of your setup
  678.      (nftp.ini, nftp.mrk, keystrokes which caused fault).
  679. Q: nftp seems to be hanging, no activity is visible
  680.      A: If this happened during transfer, try "Q". Otherwise terminate it
  681.      with Ctrl-Break.
  682.  
  683. ----------------------------------------------------------------------------
  684.  
  685. LICENSING INFORMATION
  686.  
  687. The Program (NFTP) is owned by Sergey Ayukov and is copyrighted and
  688. licensed, not sold. The term "Program" means the original program and all
  689. whole or partial copies of it.
  690.  
  691. You may:
  692.  
  693.    * use the Program
  694.    * distribute unaltered copies of the Program
  695.  
  696. You may not:
  697.  
  698.    * reverse assemble, reverse compile, or otherwise translate the Program
  699.    * sublicense, rent, or lease the Program
  700.  
  701. The Program is provided `as is'. Any express or implied warranties,
  702. including, but not limited to, the implied warranties for merchantability
  703. and fitness to a particular purpose are disclaimed. Sergey Ayukov will not
  704. be liable for any lost profits, lost savings, incident, special, or indirect
  705. damages or other economic consequential damages, even if Sergey Ayukov has
  706. been advised of the possibility of such damages. Some jurisdictions do not
  707. allow the exclusion or limitation of incidental or consequential damages, so
  708. the above limitation or exclusion may not apply to you.
  709.  
  710. The size of files that can be transferred with free version is limited to
  711. 500KB. If you want to exploit full capabilities of the Program and receive
  712. support by e-mail from author, you have to register your copy. See section
  713. Registration below. If you don't need neither to transfer files larger than
  714. 500KB nor support you don't have to register. Using unregistered version is
  715. perfectly legal; the above conditions apply. Using registered version is
  716. covered by separate license; it will be provided later.
  717. ----------------------------------------------------------------------------
  718.  
  719. ACKNOWLEDGEMENTS
  720.  
  721. Many people have helped me in creating and improving NFTP. They are (in
  722. alphabetical order):
  723.  
  724.    * Hubert Brentano (translation to German)
  725.    * Lennart Carlson (translation to Swedish)
  726.    * T≤th Ferenc (translation to Hungarian)
  727.    * Henk Hendriks (translation to Dutch)
  728.    * Stefan Hora (testing behind the firewall)
  729.    * Lord Lee (translation to Chinese)
  730.    * Kirill Lissovsky (usability comments)
  731.    * Dmitry Maloff (usability comments)
  732.    * Ivan F. Martinez (translation to Brazilian Portuguese)
  733.    * Sergey Mikhaylov (usability comments)
  734.    * Pantaleo Nacci (translation to Italian)
  735.    * Jose Ruiz (translation to Spanish)
  736.    * Kaz Shimz (translation to Japanese)
  737.    * Andrew Sukhorukov (usability comments)
  738.    * Kim Poulsen (translation to Danish)
  739.    * Kristoffer Viddal (translation to Norwegian)
  740.  
  741. Special thanks to Eberhard Mattes, author of emx/gcc development system!
  742.  
  743. This program is packaged using Info-ZIP's compression utility. Info-ZIP's
  744. software (Zip, UnZip and related utilities) is free and can be obtained as
  745. source code or executables from various bulletin board services and
  746. anonymous-ftp sites, including CompuServe's IBMPRO forum and
  747. ftp.uu.net:/pub/archiving/zip/*.
  748. ----------------------------------------------------------------------------
  749.  
  750. REGISTRATION
  751.  
  752. Registration fee will be US$ 20. For this price you'll get free updates
  753. (i.e. all future versions of NFTP) and support from author by e-mail. Single
  754. registration covers all national language versions, so if you want to run,
  755. say, English and Chinese versions, you'll have to pay only once.
  756.  
  757. If you think that price is too high for this small utility, simply don't use
  758. NFTP.
  759.  
  760. The program isn't complete, so there's nothing yet to pay for. Please wait
  761. for release version (1.0). Version 0.83 will become unregistered February 1,
  762. 1997. There should be another version this Fall.
  763.  
  764. For people living in Former Soviet Union countries registration will cost
  765. only one postcard. If you want to register in advance, send nice postcard
  766. (preferably with your home town if it's not Moscow) enclosed in envelope to
  767. Sergey Ayukov
  768. Sternberg Astronomical Institute
  769. Universitetsky pr., 13
  770. Moscow 119899
  771. Russia
  772. You will receive your registration number after sending registration form by
  773. e-mail. This form will be provided later.
  774.  
  775. Nothing else here at the moment.
  776. ----------------------------------------------------------------------------
  777.  
  778. CONTACTING THE AUTHOR
  779.  
  780. You can reach me at asv@sai.msu.su.
  781.  
  782. Where to find new versions:
  783.  
  784.   1. anonymous ftp: ftp.sai.msu.su:/pub/os2/internet/ftp/
  785.   2. WWW: http://crydee.sai.msu.su/nftp/
  786.   3. ftp-os2.cdrom.com, hobbes.nmsu.edu, ftp.leo.org
  787.  
  788. Note that first site is managed by myself so it always contains the latest
  789. version while Hobbes and cdrom archives sometimes become outdated.
  790.  
  791. Sorry for any typos and bad grammar. I will gladly accept any corrections to
  792. this short manual.
  793. ----------------------------------------------------------------------------
  794. Sergey Ayukov (asv@sai.msu.su)
  795. ----------------------------------------------------------------------------
  796.  
  797. VERSION HISTORY
  798.  
  799. Version 0.1 (preview)
  800.      First usable version. Used FTPAPI calls. Very slow; control connection
  801.      messages cannot be seen. Wasn't exposed to public, although available.
  802. Version 0.2 (preview)
  803.      Got rid of FTPAPI. Full-scale socket programming of ftp control
  804.      connection and data transfers. Introduced bookmarks.
  805. Version 0.3 (preview)
  806.      Never showed to public. The last version compiled with IBM CSet++. See
  807.      0.4.
  808. Version 0.4 (preview)
  809.      Nearly the same as 0.3, but compiled with emx 0.9a + gcc 2.6.3. A
  810.      handful of new features:
  811.         o logging in and out without restarting entire program;
  812.         o passworded entries in bookmark file;
  813.         o quick directory change: if you know where to go, you won't need to
  814.           traverse all intermediate dirs;
  815.         o various bug fixes.
  816. Version 0.5 (preview; close the beta stage)
  817.      Bugfixes plus
  818.         o ability to work in any 80xXX mode (25 <= XX)
  819.         o online context sensitive help (press F1, Shift+F1)
  820.         o code reorganization
  821.         o some errors are handled (mostly login errors)
  822.         o directory sorting by name, size, date/time
  823.         o create directory on the remote, remove file(s) on the remote
  824.         o preserving date/time of files downloaded
  825.         o fast built-in file viewer
  826.         o ability to invoke any ftp server command
  827.         o better socket selecting scheme
  828.      Will not work after 31 Dec 1995
  829. Version 0.51 (preview; close the beta stage)
  830.      I am sorry for releasing 0.5 so full of bugs... There was a lot of...
  831.         o fixed couple of awful bugs (memory corruption) resulting in core
  832.           dumps etc;
  833.         o got rid of malloc (goodbye, flat memory space! welcome, 32-bit
  834.           segments and memory protection!)
  835.         o you can set nonstandard port in nftp.ini
  836. Version 0.52
  837.      Same as 0.51 but without 31 Dec limitation. Only to be distributed by
  838.      SAMS Publishing.
  839. Version 0.53
  840.      Nearly the same as 0.52 but limited to 30 March 1996.
  841. Version 0.60
  842.      I am a bit short on time; 0.53 expires today, so some new features
  843.      weren't tested much. Bugfixes and small improvements plus:
  844.         o reget (restarting transfers)
  845.         o uploading
  846.         o IP numbers can be used instead of host names
  847.         o "Q" and "S" work! you can skip files during transfer or stop
  848.           download/upload
  849.         o more intelligent networking (fixes some problems with dynamic IP)
  850.         o changing local directory, viewing list of local files etc.
  851.         o ability to specify arbitrary port (not in bookmarks though)
  852.         o new bookmarks can be created with Insert key
  853.         o installation program
  854.         o documentation
  855. Version 0.70
  856.      Few bugfixes (including failing to recognize "hostname/directory"
  857.      format when specified in the command line) plus
  858.         o fixed nasty bug causing nftp to crash when viewing some files with
  859.           internal viewer -- thanks to Jose Ruiz who pointed out to such
  860.           file
  861.         o sort by extension
  862.         o much more error recovery; there should be no more situations when
  863.           nftp exits silently;
  864.         o improved sound signals; includes beep after successful login
  865.           (configurable)
  866.         o tables in this manual look much nicer now :-)
  867.         o firewalling support -- does not work yet
  868.         o remappable keys
  869.         o ability to specify download directory in NFTP.INI. NFTP will
  870.           change into that directory after start
  871.         o IBM TCP/IP ftpd for OS/2 is supported
  872.         o Windows NT ftpd is supported
  873.         o Windows 3.x WFTPD by Texas Imperial Software is supported
  874.         o Progress indicator in "view remote file" and during receiving of
  875.           directory listing
  876.         o You can now try to "chdir" to symbolic link
  877.         o "Parsed" directory view -- hit Ctrl-P and see
  878.         o National language support -- check out NFTP home page
  879.         o Average transfer speed is now recorded in the history (.fls file)
  880.         o Russian version
  881.         o Chinese BIG-5 version
  882.         o Spanish version
  883. Version 0.71
  884.      Several bugfixes plus
  885.         o '*' inverts selection
  886.         o f8 deletes local directories
  887.         o Neologic FTPD is supported
  888.         o moving language-dependent strings into separate DLLs (thus greatly
  889.           reducing size of the package)
  890.         o (un)marking files by template (eg, '*.txt')
  891.         o Hungarian version
  892.         o German version
  893.         o Danish version
  894.         o Japanese version
  895.         o caching of viewed remote files
  896.         o downloading all marked files from all directories (alt-f5)
  897. Version 0.72
  898.      No new functionality. Fixed small mistakes in national language
  899.      translations. Added Norwegian version. Added missing ASCII and
  900.      Postscript manuals.
  901.  
  902. Version 0.80
  903.         o Support for Neologic FTPD in UNIX emulating mode
  904.         o Support for PowerWeb FTPD
  905.         o Support for old (with DOS-like output) Windows NT ftp server
  906.         o F6 renames files/directories (on remote too)
  907.         o Alt-S saves listing of current directory into file
  908.         o left/right/ctrl-left/ctrl-right scroll remote/local directory
  909.           listing
  910.         o symbols select files starting with these symbols
  911.         o complete firewalling support (a-la WS_FTP) (wasn't completely
  912.           tested)
  913.         o built-in fileviewer now has ability to save file and search for
  914.           text
  915.         o retrieving directories/viewing files is now interruptable (with
  916.           ESC)
  917.         o when anonymous login is denied, NFTP will retry after specified
  918.           amount of time
  919.         o Italian version
  920.         o Brazilian Portuguese version
  921. Version 0.81
  922.      Mostly bugfixes. Also
  923.         o Dutch version
  924. Version 0.82
  925.      Fixed bug causing zerodivide when transferring small (<1000 bytes)
  926.      files and total size of batch transfer is larger than 1MB. NFTP now
  927.      assumes that server has Unix-like LIST output when server OS was not
  928.      recognized.
  929. Version 0.83
  930.      I am very sorry -- releasing 0.82 with 1 Oct limit was a very stupid
  931.      idea because right now I am in process of completing my PhD. I hope to
  932.      return to work on NFTP in middle October or early November. There are
  933.      no differences between 0.82 and 0.83 except expiration date. French
  934.      version is now integrated into the package.
  935.  
  936.      This version will live until 1 Feb 1997 (apparently I don't want to
  937.      disappoint you just when you're celebrating New Year ;-) I hope to
  938.      produce release (1.0) meantime.
  939.  
  940. Planned for next versions (note that not all these features will be in the
  941. first shareware version (1.0)):
  942.  
  943.    * more error recovery
  944.    * more complete docs
  945.    * more multithreading (view file while downloading etc)
  946.    * enhanced bookmarks (folders?, descriptions, URL form etc.)
  947.    * searching for string in file names
  948.    * batch mode ?
  949.    * autodownloading file descriptions (00index.txt) and showing them (a-la
  950.      CuteFTP)
  951.    * FAT support
  952.  
  953. There were several requests for PM version. I hope that I will write it
  954. sometimes, but probably not in 1996.
  955.